<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkHSV</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 3 参考手册">
<link rel="up" href="SelectorWidgets.html" title="选择器(Color/File/Font)">
<link rel="prev" href="gtk3-GtkColorSelection.html" title="GtkColorSelection">
<link rel="next" href="gtk3-GtkFileChooser.html" title="GtkFileChooser">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gtk3-GtkColorSelection.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="SelectorWidgets.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 3 参考手册</th>
<td><a accesskey="n" href="gtk3-GtkFileChooser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#gtk3-GtkHSV.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#gtk3-GtkHSV.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="gtk3-GtkHSV"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gtk3-GtkHSV.top_of_page"></a>GtkHSV</span></h2>
<p>GtkHSV</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="gtk3-GtkHSV.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gtk/gtk.h&gt;

struct              <a class="link" href="gtk3-GtkHSV.html#GtkHSV" title="struct GtkHSV">GtkHSV</a>;
<a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk3-GtkHSV.html#gtk-hsv-new" title="gtk_hsv_new ()">gtk_hsv_new</a>                         (<em class="parameter"><code><span class="type">void</span></code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkHSV.html#gtk-hsv-set-color" title="gtk_hsv_set_color ()">gtk_hsv_set_color</a>                   (<em class="parameter"><code><a class="link" href="gtk3-GtkHSV.html#GtkHSV" title="struct GtkHSV"><span class="type">GtkHSV</span></a> *hsv</code></em>,
                                                         <em class="parameter"><code><span class="type">double</span> h</code></em>,
                                                         <em class="parameter"><code><span class="type">double</span> s</code></em>,
                                                         <em class="parameter"><code><span class="type">double</span> v</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkHSV.html#gtk-hsv-get-color" title="gtk_hsv_get_color ()">gtk_hsv_get_color</a>                   (<em class="parameter"><code><a class="link" href="gtk3-GtkHSV.html#GtkHSV" title="struct GtkHSV"><span class="type">GtkHSV</span></a> *hsv</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *h</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *s</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *v</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkHSV.html#gtk-hsv-set-metrics" title="gtk_hsv_set_metrics ()">gtk_hsv_set_metrics</a>                 (<em class="parameter"><code><a class="link" href="gtk3-GtkHSV.html#GtkHSV" title="struct GtkHSV"><span class="type">GtkHSV</span></a> *hsv</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> ring_width</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkHSV.html#gtk-hsv-get-metrics" title="gtk_hsv_get_metrics ()">gtk_hsv_get_metrics</a>                 (<em class="parameter"><code><a class="link" href="gtk3-GtkHSV.html#GtkHSV" title="struct GtkHSV"><span class="type">GtkHSV</span></a> *hsv</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *size</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *ring_width</code></em>);
<a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk3-GtkHSV.html#gtk-hsv-is-adjusting" title="gtk_hsv_is_adjusting ()">gtk_hsv_is_adjusting</a>                (<em class="parameter"><code><a class="link" href="gtk3-GtkHSV.html#GtkHSV" title="struct GtkHSV"><span class="type">GtkHSV</span></a> *hsv</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkHSV.html#gtk-hsv-to-rgb" title="gtk_hsv_to_rgb ()">gtk_hsv_to_rgb</a>                      (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> s</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> v</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *r</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *g</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *b</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="gtk3-GtkHSV.html#gtk-rgb-to-hsv" title="gtk_rgb_to_hsv ()">gtk_rgb_to_hsv</a>                      (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> g</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> b</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *h</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *s</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *v</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="gtk3-GtkHSV.description"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1">
<a name="gtk3-GtkHSV.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GtkHSV"></a><h3>struct GtkHSV</h3>
<pre class="programlisting">struct GtkHSV {
  GtkWidget parent_instance;
};
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-hsv-new"></a><h3>gtk_hsv_new ()</h3>
<pre class="programlisting"><a class="link" href="gtk3-GtkWidget.html#GtkWidget" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_hsv_new                         (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>
Creates a new HSV color selector.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A newly-created HSV color selector.</td>
</tr></tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-hsv-set-color"></a><h3>gtk_hsv_set_color ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_hsv_set_color                   (<em class="parameter"><code><a class="link" href="gtk3-GtkHSV.html#GtkHSV" title="struct GtkHSV"><span class="type">GtkHSV</span></a> *hsv</code></em>,
                                                         <em class="parameter"><code><span class="type">double</span> h</code></em>,
                                                         <em class="parameter"><code><span class="type">double</span> s</code></em>,
                                                         <em class="parameter"><code><span class="type">double</span> v</code></em>);</pre>
<p>
Sets the current color in an HSV color selector.
Color component values must be in the [0.0, 1.0] range.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>hsv</code></em> :</span></p></td>
<td>An HSV color selector</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>h</code></em> :</span></p></td>
<td>Hue</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>s</code></em> :</span></p></td>
<td>Saturation</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>v</code></em> :</span></p></td>
<td>Value</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-hsv-get-color"></a><h3>gtk_hsv_get_color ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_hsv_get_color                   (<em class="parameter"><code><a class="link" href="gtk3-GtkHSV.html#GtkHSV" title="struct GtkHSV"><span class="type">GtkHSV</span></a> *hsv</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *h</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *s</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *v</code></em>);</pre>
<p>
Queries the current color in an HSV color selector.
Returned values will be in the [0.0, 1.0] range.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>hsv</code></em> :</span></p></td>
<td>An HSV color selector</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>h</code></em> :</span></p></td>
<td>Return value for the hue. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>s</code></em> :</span></p></td>
<td>Return value for the saturation. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>v</code></em> :</span></p></td>
<td>Return value for the value. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-hsv-set-metrics"></a><h3>gtk_hsv_set_metrics ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_hsv_set_metrics                 (<em class="parameter"><code><a class="link" href="gtk3-GtkHSV.html#GtkHSV" title="struct GtkHSV"><span class="type">GtkHSV</span></a> *hsv</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> ring_width</code></em>);</pre>
<p>
Sets the size and ring width of an HSV color selector.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>hsv</code></em> :</span></p></td>
<td>An HSV color selector</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
<td>Diameter for the hue ring</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ring_width</code></em> :</span></p></td>
<td>Width of the hue ring</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-hsv-get-metrics"></a><h3>gtk_hsv_get_metrics ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_hsv_get_metrics                 (<em class="parameter"><code><a class="link" href="gtk3-GtkHSV.html#GtkHSV" title="struct GtkHSV"><span class="type">GtkHSV</span></a> *hsv</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *size</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *ring_width</code></em>);</pre>
<p>
Queries the size and ring width of an HSV color selector.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>hsv</code></em> :</span></p></td>
<td>An HSV color selector</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
<td>Return value for the diameter of the hue ring. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ring_width</code></em> :</span></p></td>
<td>Return value for the width of the hue ring. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-hsv-is-adjusting"></a><h3>gtk_hsv_is_adjusting ()</h3>
<pre class="programlisting"><a href="../glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_hsv_is_adjusting                (<em class="parameter"><code><a class="link" href="gtk3-GtkHSV.html#GtkHSV" title="struct GtkHSV"><span class="type">GtkHSV</span></a> *hsv</code></em>);</pre>
<p>
An HSV color selector can be said to be adjusting if multiple rapid
changes are being made to its value, for example, when the user is 
adjusting the value with the mouse. This function queries whether 
the HSV color selector is being adjusted or not.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>hsv</code></em> :</span></p></td>
<td>A <a class="link" href="gtk3-GtkHSV.html#GtkHSV" title="struct GtkHSV"><span class="type">GtkHSV</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="../glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if clients can ignore changes to the color value,
since they may be transitory, or <a href="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if they should consider
the color value status to be final.</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-hsv-to-rgb"></a><h3>gtk_hsv_to_rgb ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_hsv_to_rgb                      (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> s</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> v</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *r</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *g</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *b</code></em>);</pre>
<p>
Converts a color from HSV space to RGB.
Input values must be in the [0.0, 1.0] range; 
output values will be in the same range.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>h</code></em> :</span></p></td>
<td>Hue</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>s</code></em> :</span></p></td>
<td>Saturation</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>v</code></em> :</span></p></td>
<td>Value</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>r</code></em> :</span></p></td>
<td>Return value for the red component. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>g</code></em> :</span></p></td>
<td>Return value for the green component. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
<td>Return value for the blue component. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-rgb-to-hsv"></a><h3>gtk_rgb_to_hsv ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_rgb_to_hsv                      (<em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> g</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> b</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *h</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *s</code></em>,
                                                         <em class="parameter"><code><a href="../glib/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *v</code></em>);</pre>
<p>
Converts a color from RGB space to HSV.
Input values must be in the [0.0, 1.0] range;
output values will be in the same range.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>r</code></em> :</span></p></td>
<td>Red</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>g</code></em> :</span></p></td>
<td>Green</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
<td>Blue</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>h</code></em> :</span></p></td>
<td>Return value for the hue component. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>s</code></em> :</span></p></td>
<td>Return value for the saturation component. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>v</code></em> :</span></p></td>
<td>Return value for the value component. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.14</p>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.18</div>
</body>
</html>